Estamos atualizando a API Data para corresponder à forma como o YouTube conta as visualizações dos Shorts.
Saiba mais
Implementação: paginação
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O exemplo a seguir mostra como recuperar outros conjuntos de resultados para consultas da API Data do YouTube (v3).
A API usa o parâmetro maxResults
para indicar quantos itens devem ser incluídos em uma resposta da API. Quase todos os métodos list
da API (videos.list
, playlists.list
etc.) são compatíveis com esse parâmetro.
Se houver outros resultados disponíveis para uma consulta, a resposta da API vai conter uma propriedade nextPageToken
, uma propriedade prevPageToken
ou ambas. Os valores dessas propriedades podem ser usados para definir o parâmetro pageToken
e recuperar outra página de resultados.
Por exemplo, a consulta a seguir recupera os resultados de pesquisa dos 10 vídeos mais visualizados que correspondem à consulta "skateboarding dog":
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
part=snippet
&maxResults=10
&order=viewCount
&q=skateboarding+dog
&type=video
A resposta da API contém as primeiras 10 correspondências da consulta, além de uma propriedade nextPageToken
que pode ser usada para recuperar os próximos 10 resultados:
A consulta abaixo recupera os próximos 10 resultados:
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
part=snippet
&maxResults=10
&order=viewCount
&pageToken=CAoQAA
&q=skateboarding+dog
&type=video
Observação:talvez seja necessário atualizar o valor do parâmetro pageToken
para concluir essa solicitação no APIs Explorer. Execute a consulta que recupera os 10 primeiros resultados para conseguir o valor correto do parâmetro pageToken
.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2024-11-23 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2024-11-23 UTC."],[[["The YouTube Data API (v3) uses the `maxResults` parameter to determine the number of items returned in a query response."],["API `list` methods, such as `videos.list` and `playlists.list`, support the `maxResults` parameter for pagination."],["If more results are available, the API response includes `nextPageToken` and/or `prevPageToken` properties."],["These token values can be used to set the `pageToken` parameter to retrieve additional result pages."],["The initial request fetches the first page of results, and subsequent requests use the `pageToken` from the previous response to get the next page of results."]]],["The YouTube Data API (v3) uses `maxResults` to specify the number of items in a response. `list` methods support this, and responses with additional results include `nextPageToken` or `prevPageToken`. These tokens, used with the `pageToken` parameter, retrieve further result sets. For instance, a query can get 10 most viewed videos, and a `nextPageToken` in the response allows fetching the next 10 by adding this value in the `pageToken` parameter.\n"]]